::=====================================
::Teenage Mutant Ninja Turtles of Rage
::The Final Shell Shock v1.999.1
::Re-Shelled MD+ v1.10.3.1
::Re-Shelled MSU-MD v1.0
::By eskayelle
::=====================================
::
::ONLY APPLY ONE OF THESE PATCHES TO A CLEAN / PRISTINE / ORIGINAL COPY OF THE SOR2 ROM!
::
::*****INSTRUCTIONS FOR NORMAL PLAY*****
::(TO PLAY IN ANY GENESIS / MEGA DRIVE OR EMULATOR...)
::What you'll need --
::1) A USA Streets of Rage 2 (Genesis / Mega Drive) ROM
::2) A TMNT of Rage - The Final Shell Shock v1.999.1 [U] [h].ips patch
::3) A patching program (Lunar IPS, FLIPS, Unipatcher...)
::
::What you'll do --
::1) Apply a copy of the TMNT of Rage - The Final Shell Shock v1.999.1 [U] [h].ips patch to an original SOR2 Genesis / Mega Drive ROM.
::2) Insert the ROM in a directory associated with your favorite emulator (or flash cart), and play!
::
::Note: This mod will work in all known Windows, Linux, and Android Genesis / Mega Drive emulators,
::as well as all known flash carts (e.g., Terraonion MegaSD and Mega Everdrive).
::
::
::*****INSTRUCTIONS FOR TERRAONION MEGASD MD+ FEATURE USE*****
::(IF YOU WANT TO PLAY WITH MD+ SOUND FEATURES ON THE TERRAONION MEGASD FLASH CART...)
::What you'll need --
::1) A USA Streets of Rage 2 (Genesis / Mega Drive) ROM
::2) A Teenage Mutant Ninja Turtles of Rage Re-Shelled (MD+) v1.10.3.1 [U] [h].ips patch
::3) A patching program (Lunar IPS, FLIPS, Unipatcher...)
::4) A Terraonion MegaSD cartridge (and a formatted microSD card)
::5) A console compatible with the MegaSD (Genesis/Mega Drive or Analogue Mega SG)
::
::Please note: 
::The Teenage Mutant Ninja Turtles of Rage Re-Shelled (MD+) v1.10.3.1 [U] [h].ips patch 
::is made specifically for use with the Terraonion MegaSD cartridge.  
::Music will not play if this mod is used on emulators without MD+ capabilty.
::Until emulators are made available supporting MD+, this patch will only work correctly with the Terraonion MegaSD.
::
::Currently, the Terraonion MegaSD supports both MD+ and MSU-MD, and the only emulator supporting MD+ is MD MAME.
::MD MAME is discussed at https://www.zeldix.net/t2175-md-mame
::Eke may be working on MD+ further for Genesis Plus GX: https://github.com/ekeeke/Genesis-Plus-GX/Issues/297
::
::What you'll do --
::1) Apply a copy of the Teenage Mutant Ninja Turtles of Rage Re-Shelled (MD+) v1.10.3.1 [U] [h].ips patch to an original SOR2 Genesis / Mega Drive ROM.
::2) Be sure to rename the extension of the newly patched TMNT Re-Shelled ROM to .md (not .gen or .bin).
::3) Download the .zip of the .cue sheet and music files from MEGA.  Go to https://mega.nz/#!nB0z0SRC!2dJ9bYE3fo58F4ZkptIPSsOp_5tF2f0i9pXemTw4vqc
::4) Extract all .wav music files and .cue sheet to an empty directory/folder.
::5) Move the Teenage Mutant Ninja Turtles of Rage Re-Shelled (MD+) v1.10.3.1 [U] [h].md file to that same directory/folder.
::6) Place the folder with the .md, .cue, and .wav files on the root of the microSD card you will be using with the MegaSD.
::Note: Do not place the .ips file in the folder.
::7) Insert microSD card in MegaSD, locate the directory, and play!
::
::Note: If you are using an Analogue Mega SG, be sure to enable cartidge audio via the Mega SG's Settings > Audio menu.
::
::Note: Make sure you rename the .cue file so it matches the name of the .md file.
::
::Note: If the game fails to start at all (e.g., a red screen is displayed),
::use the application FixCheckSum to fix the checksum.
::
::
::*****INSTRUCTIONS FOR MEGA EVERDRIVE MSU-MD FEATURE USE*****
::(IF YOU WANT TO PLAY WITH MSU-MD SOUND FEATURES ON THE MEGA EVERDRIVE FLASH CART...)
::What you'll need --
::1) A USA Streets of Rage 2 (Genesis / Mega Drive) ROM
::2) A Teenage Mutant Ninja Turtles of Rage Re-Shelled (MSU-MD) v1.0 [U] [h].ips patch
::3) A patching program (Lunar IPS, FLIPS, Unipatcher...)
::4) A Mega Everdrive cartridge (and a formatted microSD card)
::5) A console compatible with the Mega Everdrive (Genesis/Mega Drive or Analogue Mega SG)
::
::Please note: 
::The Teenage Mutant Ninja Turtles of Rage Re-Shelled (MSU-MD) v1.0 [U] [h].ips patch 
::is made specifically for use with Krikzz's Mega Everdrive cartridge.  
::Music will not play if this mod is used on emulators without MSU-MD capabilty.
::The MSU-MD patch itself may cause the game to softlock after beating Stage 8 and entering initials.
::This is a flaw in the MSU-MD patch designed by Krikzz for the original SOR2 game, that patch being incorporated here.
::Further, MSU-MD takes advantage of Mode 1 and currently cannot loop songs. 
::Instead, when a song finishes, instead of looping, it will play the next track.
::An easy fix is to use Audacity or another sound editor to copy the contents of a .wav file and append it to the end several times.
::This creates manual loops at the cost of memory.
::
::This Re-Shelled hack will also work with RetroArch on the Nintendo Wii, provided the proper .dol core for Genesis Plus GX is installed.
::Grab the genplus_wii.dol from https://bitbucket.org/eke/genesis-plus-gx/src/master/builds/
::A Sega CD bios must also be placed in the RetroArch system folder.
::
::The hack will also work in the Windows version of RetroArch, but only the first track plays in all spots music is supposed to run.
::For play in Windows, grab the appropriate genesis_plus_gx_libretro.dll from https://mega.nz/folder/rgEVzAZK#uo-JSeS_abL94eE9xaNc6w.
::Again, a Sega CD bios (renamed bios_cd_u.bin) must be placed in the appropriate RetroArch folder.
::
::What you'll do --
::1) Apply a copy of the Teenage Mutant Ninja Turtles of Rage Re-Shelled (MSU-MD) v1.0 [U] [h].ips patch to an original SOR2 Genesis / Mega Drive ROM.
::2) Be sure to rename the extension of the newly patched TMNT Re-Shelled ROM to .md (not .gen or .bin).
::3) Download the .zip of the .cue sheet and music files from MEGA.  Go here: https://mega.nz/file/nQUQmDyZ#ZDitZnim370h8_tAMnoIVQvQnHehPAOyi6wYDajnwfI
::4) Extract all .wav music files and .cue sheet to an empty directory/folder.
::5) Move the Teenage Mutant Ninja Turtles of Rage Re-Shelled (MSU-MD) v1.0 [U] [h].md file to that same directory/folder.
::6) Place the folder with the .md, .cue, and .wav files on the root of the microSD card you will be using with the Mega Everdrive.
::Note: Do not place the .ips file in the folder.
::7) Insert microSD card in Mega Everdrive, locate the directory, and play!
::
::Note: Make sure you rename the .cue file so it matches the name of the .md file.
::
::Note: The Mega Everdrive only supports MSU-MD (not MD+), and MSU-MD is supported by Genesis GX Plus.
::
::Note: If the game fails to start at all (e.g., a red screen is displayed),
::use the application FixCheckSum to fix the checksum.
::
::
::
::---------------
::ORIGINAL README
::---------------
::============================================================
::Teenage Mutant Ninja Turtles of Rage - The Final Shell Shock
::By eskayelle
::August/September/October/November 2019
::February/March/April 2020
::============================================================
::
::**CONTENTS**
::
::*****INTRODUCTION*****
::*****TOOLS USED*****
::*****MOVE LIST*****
::*****CREDITS*****
::*****ADDITIONAL NOTES*****
::*****RE-SHELLED NOTES*****
::
::
::*****INTRODUCTION*****
::
::Cowabunga!  For years, I've been wanting to play a new Ninja Turtles game,
::akin to the old arcade ones, or the ones on the 16-bit consoles.
::A couple years ago, I discovered a great TMNT hack of Streets of Rage 2 by Carzj.
::
::Some time last year, I found on RHDN a portrait editing tutorial for the game, as written by Dha Lau Hoo.
::While deep into my NBA Jam TE hacks, I remembered that there were a few changes I'd
::have made to that great TMNT Edition hack if I could... like portraits and names on the player select screen...
::maybe add a few shadows where the turtles seemed to float during gameplay...
::
::So I decided to give an update to the hack a go.  And then I just kept going...
::
::And the result is this...  Reaganomics!
::
::
::The TMNT of Rage - The Final Shell Shock vx.xx.xx [U] [h].bin file is a modified Genesis ROM of Streets of Rage 2;
::it's also an addendum to Carzj's TMNT Edition hack, adding too many improvements to cite in this document,
::and in essence making it a whole (different) new ROM. 
::The romhack is distributed as an IPS patch, which should be patched to an original USA Streets of Rage 2 ROM. 
::
::The ROM can be opened and played via several emulators, including in Windows, Linux, and Android environments.
::
::The following is a list of known Windows or Android emulators within which this ROM works;
::note that it also works with Raspberry Pi/RetroArch. 
::
::Windows--
::1) Fusion v3.64
::2) Gens v11c r57shell mod r665
::3) RetroArch build date Feb 3 2019
::
::Android--
::1) MD.emu v1.5.37
::
::
::*****TOOLS USED*****
::Pancake 2 v1.5 and v1.6
::SoR2 Level Editor v1.0
::Gens v11c r57shell mod r665 debugger and trace logs
::TileMolester v0.16
::FixCheckSum
::SonMapEd v1.05
::HivePal v02
::xvi32
::HxD v.1.7.7.0
::AddIntroGen v1.01
::EASy68K Editor/Assembler v5.16.01
::Tile Layer Pro v1.1
::
::
::*****MOVE LIST*****
::Regular Attack = B
::Flurry of Attacks = B repeatedly
::Charge Attack = Hold and release B
::Blitz Attack = (L+L or R+R) + B
::Rear Attack = B + C
::Jump Kick = (L or R) + C + B
::Drop Kick = C + Down + B
::(Grab) Power Hit = Wait one second, then B
::(Grab) Flurry Attack 1 = B repeatedly
::(Grab) Flurry Attack 2 = (L or R) toward enemy + B
::(Grab) Body Throw = (L or R) away from enemy + B
::(Grab) Slam = C + B
::Defensive Special = A
::Offensive Special = B + A
::(While Being Thrown) Counter = Hold Up and tap C
::Throw Weapon = Pick up weapon, then hold C and tap B
::
::
::*****CREDITS*****
::Big thanks to the following folks for their previous work on SOR2 or the assets / documentation they provided me.
::1) Carzj for the original TMNT Edition hack.
::2) SCD for the restoration hack.
::3) Dha Lau Hoo the portraits tutorial and guidance on editing name titles at the player select screen.
::4) Metal64 for the character physics guide.
::5) Wake for help with formatting the color schemes for the new portraits.
::6) savok for the run code and guidance on making mini-portraits, plus the Pancake resizer guidance.
::7) Sharpnull for the image compression utility.
::8) The 3 Lil Js for playtesting.
::9) MarkeyJester, Reaper Man, and RadioShadow for guidance on hacking the SoR2 title screen!
::10) The Spriters Resource and Enscripture for the Shredder TMNT Tournament Fighters sprites (and Arcade TMNT Bebop & Rocksteady).
::11) Ti for the No Friendly Fire hack.
::12) Sik, erik, and Mask of Destiny on the plutiedev Discord for ASM advice.
::13) Yoni for the original pizza slice image and additional sound pointers.
::14) Infinest for creating the hooks that allow SOR2 games to take advantage of MD+.
::15) Krikzz for converting the SOR2 MD+ patch to be compatible with MSU-MD.
::
::
::*****ADDITIONAL NOTES*****
::
::The following Game Genie or PAR codes may not work in this game:
::::Infinite continues (AL7T-AA62, or #$6002 at address $BB98)
::::99 lives on option screen
::::Various Infinite Energy / Health codes
::::Start with X lives
::::Start with X difficulty
::But then... do you REALLY need them anyway???
::
::
::*****RE-SHELLED MD+ NOTES*****
::Known Issues --
::1)
::During the Duel, often when Stage 3 is selected,
::the first round will play the Select Your Turtle music (#$0118),
::instead of Skull and Crossbones (#$0109).
::It fixes itself in Round 2.
::(Regardless, offset $A308 is properly set to #$0109, Skull and Crossbones.)
::
::2)
::Often during campaign Stage 3, specifically the pirate ship area (Stage 3-5), 
::the music will not switch over to Skull and Crossbones (#$0109).
::
::3)
::After defeating Mr. X, when the stage clears, rather than playing the stage clear tune,
::the game may instead continue the Revenge of Mr. X song.
::When this happens, it'll play through the initials entry screen,
::only to stop when the ending song (Flying High) starts.
::
::4)
::In Stage 6-2, the game will unpause the Wave 131 song,
::rather than play the song assigned at its track offset...
::unless Stage 6-2's music and Duel Stage 6's music are the same value.
::
::*****
::
::Track Info --
::Byte Indicators for Songs: 01 XX 72 4E B9
::
::Stage Music Offsets:
::230B8 - Intro (#$010A - SOR Super Mix)
::70E0 - Select Your Player (#$0118  Select Your Turtle)
::99D6 - Stage 1-1 (#$0100 - Fire!)
::9A70 - Stage 1-2 (#$0103  Smooth Criminal)
::9CA6 - Stage 1-3 (#$0117  Ready Funk)
::9A91 - Unknown
::9C7E - Stage 2-1 (#$0107  Big Apple, 3am)
::9CA6 - Stage 2-2 (#$0117  Ready Funk)
::9B58 - Stage 2-3 (#$0107  Big Apple, 3am)
::1A940 - Stage 2-3 Boss  (#$0102  Fight! --> #$0112 - Never Return Alive)
::9E4E - Stage 3-1, 3-2, 3-3, & 3-4 (#$010F  Dreamer)
::9CC8 - Stage 3-5 (#$0109 - Skull and Crossbones)
::9EC2 - Stage 3-6 (#$010F - Dreamer)
::9FAC - Alien House (Stage 3-7) (#$0114 - Underground)
::A020 - Stage 4-1 and 4-2 (#$0111  Under Logic)
::A0BE - Stage 4-3 (#$0108  Down the Elevator)
::A0E0 - Stage 4-4 Boss Room (#$0102  Make #$0112  Never Return Alive --> #$0102 - Fight!)
::9D6E - Stage 5 (all) (#$0106  Slow Moon)
::9BC0 - Stage 5-3 Boss (#$0102  Fight!)
::9C0C - Stage 6-1 (#$010D  Wave 131)
::9D96 - Stage 6-2 (#$0104  Guile)
::9A02 - Stage 6-2 Boss (#$0102  Fight! --> #$0112 - Never Return Alive)
::A160 - Stage 7-1 (#$0101  Go Straight)
::A180 - Stage 7-2 (#$0115  Bury My Shell)
::9BAC - Stage 7-2 Boss (#$0102  Fight! --> #$0112 - Never Return Alive)
::A20A - Stage 8 (all) (#$011A  Back to the Industry)
::1EC84  Shiva (#$010E  Final Boss)
::1EF14 - Mr. X (#$0113  Revenge of Mr. X)
::89BC - Stage Clear (#$010B  Clear Two)
::22D6E  Ending (#$011B  Flying High)
::7AAC - Game Over (#$0119  Game Over)
::633E - Hi Score Table (#$010B  Clear Two)
::1842C - Appears to be Stage 3 Boss (Zamza)
::NOT USED: #$0116
::
::Duel Music Offsets:
::A288 - Stage 1 (#$0112)  Make Fight! (#$0102)
::A2AC - Stage 2 (#$0117)  Keep Ready Funk (#$0117)
::A308 - Stage 3 (#$0116)  Make Skull and Crossbones (#$0109)
::A332 - Stage 4 (#$0102)  Make Never Return Alive (#$0112)
::A38A - Stage 5 (#$0106)  Make Bury My Shell (#$0115)
::A3DE - Stage 6 (#$010D)  Make Guile (#$0104)
::A420 = Stage 7 (#$011A)  Keep as Industry (#$011A)
::A44A = Stage 8 (#$010A)  Make Final Option (#$0105)
::
::Level Music Bytes (#$01XX, where track XX is provided below):
::00 = Go Straight ingame mix - BGM 00  |  Fire!
::01 = Go Straight unused mix - BGM 01  |  Go Straight
::02 = Never Return Alive (Boss theme) - BGM 02  |  Fight!
::03 = At the Bar used version - BGM 03  |  Smooth Criminal
::04 = At the Bar Unused Slow Version - BGM 04  |  Guile
::05 = Jungle Base - BGM 05  |  Final Option
::06 = Slow Moon - BGM 06  |  Slow Moon
::07 = Spin on the Bridge - BGM 07  |  Big Apple, 3am
::08 = Too Deep - BGM 08  |  Down the Elevator
::09 = Little Money Avenue - BGM 09  |  Skull and Crossbones
::0A = SOR Super Mix - BGM 10  |  SOR Super Mix
::0B = Stage Clear - BGM 11  |  Clear Two
::0C = Silence
::0D = Wave 131 - BGM 12  |  Wave 131
::0E = Max Man - BGM 13  |  Final Boss
::0F = Dreamer - BGM 14  |  Dreamer
::10 = Silence
::11 = Under Logic - BGM 15  |  Under Logic
::12 = Never Return Alive with Rain Effect sound at the beginning - BGM 16  |  Never Return Alive
::13 = Revenge of Mr. X - BGM 17  |  Revenge of Mr. X
::14 = Alien Power - BGM 18  | Underground
::15 = Expander - BGM 19  |  Bury My Shell
::16 = Ready Funk (clean version) - BGM 20 |  Ready Funk
::17 = Ready Funk (Motor version) - BGM 21  |  Ready Funk
::18 = Player Select - BGM 22  |  Select Your Turtle
::19 = Game Over - BGM 23  |  Game Over
::1A = Back to Industry - BGM 24  |  Back to the Industry
::1B = Good End - BGM 25  |  Flying High